home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / printing / magicfil.2 / magicfilter-1.2.tar / magicfilter-1.2 / QuickInst < prev    next >
Text File  |  1996-03-17  |  3KB  |  83 lines
  1. Quick installation instructions:
  2.  
  3. * Run "configure".  If you want to put the files in any other directory
  4.   tree than /usr/local (i.e. /usr/local/bin, /usr/local/man) then call
  5.   it with the option --prefix=<directory-prefix>, for example:
  6.  
  7.     ./configure --prefix=/usr
  8.  
  9.   See the file INSTALL for more information.
  10.  
  11. * Run "make".
  12.  
  13. * Run "make install".
  14.  
  15. * If you want to install all the sample printer filters (there are 40
  16.   of them in the 1.1 release) then do "make install_filters".
  17.   Otherwise pick the one(s) you want from the "filters" directory and
  18.   put them in the appropriate location.  Make sure they are executable
  19.   (they can be considered "scripts", with magicfilter being the interpreter.)
  20.  
  21. -----------------------------------------------------------------------------
  22.  
  23. The following instructions apply only to systems using the BSD
  24. printing system.  Linux and BSD-derived OSes all use the BSD printing
  25. system, some System V-based systems such as IRIX do as an option
  26. whereas others, such as Solaris, do not.
  27.  
  28. If in doubt, check for the existence of the file /etc/printcap.
  29.  
  30. NOTE: The standard BSD print daemon does *not* support filters for
  31. remote printers, hence the instructions below apply only to systems
  32. which have the printers physically attached.  A version of lpd which
  33. does not have this problem is available as a part of the LPRng package
  34. from ftp://dickory.sdsu.edu/pub/LPRng/.  To use filters with remote
  35. printers for LPRng, specify the "bqfilter" flag in /etc/printcap, for
  36. example:
  37.  
  38.   # Remote HP LaserJet 4 (possibly connected via built-in Ethernet)
  39.   remoteprinter:\
  40.     :lp=:rm=printserver:rp=remoteprinter:\
  41.     :sd=/var/spool/lpd/remoteprinter:\
  42.     :bqfilter:mx#0:\
  43.     if=/usr/local/bin/ljet4-filter:
  44.  
  45. -----------------------------------------------------------------------------
  46.  
  47. * Edit your /etc/printcap file to contain a call to the appropriate
  48.   printer filter in the "if" entry of each local printer.  This will
  49.   typically look something like this:
  50.  
  51.   pencil|lp|PostScript|ljet4|HP LaserJet 4:\
  52.     :lp=/dev/lp1:sd=/var/spool/lpd/pencil:sh:mx#0:\
  53.     :if=/usr/local/bin/ljet4-filter:
  54.  
  55.   crayon|dj550c|color|HP DeskJet 550C:\
  56.     :lp=/dev/lp2:sd=/var/spool/lpd/crayon:sh:mx#0:\
  57.     :if=/usr/local/bin/dj550c-filter:
  58.  
  59.   Note the alias "lp" for the default (text) printer, and "PostScript"
  60.   for the preferred PostScript printer.
  61.  
  62.   IMPORTANT: If you're on a really old version of UNIX which doesn't
  63.   support the so-called "#!-hack" for selecting an interpreter for
  64.   your filters, this form of installation does not work.  Instead, you
  65.   need to make your /etc/printcap file look something like this:
  66.  
  67.   pencil|lp|PostScript|ljet4|HP LaserJet 4:\
  68.     :lp=/dev/lp1:sd=/var/spool/lpd/pencil:sh:mx#0:\
  69.     :if=/usr/local/bin/magicfilter:\
  70.     :af=/usr/local/bin/ljet4-filter:
  71.  
  72.   To test if your OS supports the #!-hack, type at the command line:
  73.  
  74.     /usr/local/bin/XXXX-filter < /dev/null
  75.  
  76.   ... where XXXX-filter is any installed magic filter.  If you get an
  77.   error message, your OS does *not* support the #!-hack.
  78.  
  79.   Linux, all BSD-derived OSes and System V R3 and later all support
  80.   the #!-hack.
  81.  
  82. * Kill and restart lpd.  Your printer filter should now be working.
  83.